home *** CD-ROM | disk | FTP | other *** search
/ PC Media 4 / PC MEDIA CD04.iso / share / udos / zdir20 / readme.doc next >
Text File  |  1992-03-03  |  17KB  |  339 lines

  1. This file contains three sections:  ZanySoft programs, ZDir notes, and ZDir
  2. release history.
  3.  
  4. Zanysoft programs:
  5. -------------------------------------------------------------------------------
  6.         ZDir, a powerful directory utility with coloring by extension, sorting,
  7.                 easy configuration, full wildcards, and more.
  8.                 Current version: 2.0
  9.  
  10.         ZD86 (ZanySoft Debugger), a powerful symbolic debugger with pull down
  11.                 and pop up menus, multiple resizable overlapping windows, and
  12.                 of course, it is fully configurable.
  13.                 Current version: 1.01
  14.  
  15. ZDir notes:
  16. -------------------------------------------------------------------------------
  17.  
  18. ZanySoft Dir (ZDir) is an easy to use and very powerful directory lister.  The
  19. main purpose of ZDir is to replace the generic DIR command with a fast, easily
  20. readable display with more functionality.  It can organize the file listing
  21. with many sorting options, color files based upon their extension, choose how
  22. many columns to use in the display, find files, draw a tree of the directory
  23. structure, use full-scale wildcards, and much more.  Besides being powerful and
  24. easy to use, ZDir is also easy to configure with the included configuration
  25. program ZDircfg.  It is very easy for a novice computer user to learn how to
  26. use ZDir, but has many features that expand upon the basic directory listing
  27. capability.
  28.  
  29. The complete ZDir package consists of ZDir.com, ZDir.doc, ZDircfg.exe, and
  30. Readme.doc (this file).  If you do not have all of these files, then you do not
  31. have the complete ZDir package version 2.0.  If you want to jump right in to
  32. using ZDir, pause for a second and read section 3 of ZDir.doc, the Quick-start.
  33. It should give you a brief overview of what ZDir is all about in only a couple
  34. of minutes.
  35.  
  36. ZDir is Shareware, and if you choose to use it after a short trial period then
  37. you are obligated to pay for it.  For a more thorough discussion of Shareware,
  38. see section 2 of the manual (ZDir.doc).  Typing ZDir /R from the DOS prompt
  39. will display a registration form, which you can print out, fill out, and send
  40. in.
  41.                             
  42. ZDir release history:
  43. -------------------------------------------------------------------------------
  44.         2.0 Enhancements:
  45.  
  46.                 Full-scale wildcards are now accepted.  Full wildcards are much
  47.                 more flexible than normal DOS wildcards:  *'s and ?'s can be
  48.                 put anywhere, such as ZDir *z??d*8*6?.?o* .  Since this
  49.                 replaces string searching, string searching has been removed.
  50.                 For the same function, just surround the string with *, like
  51.                 this: ZDir *string* .
  52.  
  53.                 The configuration option as well as many other options have
  54.                 been removed from ZDir and placed into a separate configuration
  55.                 program called ZDircfg.  This should make the configuration
  56.                 and upgrading of ZDir painless.  ZDircfg is a menu driven
  57.                 program that allows you to set all colors, defaults, and
  58.                 extensions, and save and load configuration information
  59.                 from ZDir.  Because of this, most configuration options have
  60.                 been removed from ZDir for ease of use, so only non-configurable
  61.                 commands (/F, /?, and /R for example) are left.  Changing
  62.                 the number of columns and primary sort are still available
  63.                 on the command line of ZDir for one-time runs, which you
  64.                 do not want to make defaults.
  65.  
  66.                 New feature /T added to make a directory tree from the
  67.                 specified directory on down, giving the number of files
  68.                 and total size of each directory, adding up only files which
  69.                 match the filespec.
  70.  
  71.                 Option added in ZDircfg to have directories appear clumped
  72.                 together at the beginning or end of the file list, or sorted
  73.                 with other files like in the past.
  74.  
  75.                 Configured extensions may now have wild cards in them!  Lower
  76.                 number extensions have priority, so that the more general the
  77.                 extension specification (w or w/o wildcards) the earlier in
  78.                 the extension list it should be put (C should be earlier than
  79.                 C??, otherwise the C?? color would be found before the C color).
  80.  
  81.                 A new command line option, /U, makes ZDir only list files
  82.                 that match "user extensions", which are set in ZDircfg.
  83.  
  84.                 When prompted to press any key, the Enter key prints one line
  85.                 and then waits for another key.  Any key except for the Enter
  86.                 key prints another full screen of data.
  87.  
  88.                 ZDir works with size text screen, including 132 column text
  89.                 modes of many super VGA cards.
  90.  
  91.                 Setting sorting by attribute on the command line removed,
  92.                 and writing ANSI color codes to the file specified by /L,
  93.                 which used to by /M, is now /A
  94.  
  95.                 Disks with a serial number now optionally have the serial
  96.                 number printed next to the volume label.
  97.  
  98.                 In alternate output files, interecting or corner lines are
  99.                 now represented by +, not *.
  100.  
  101.                 Sorting by attribute eliminated--it's useless.
  102.  
  103.         2.0 Bug fixes:
  104.  
  105.                 File sizes of over 100,000 were often reported slightly
  106.                 lower than the actual size.  *Fixed*
  107.  
  108.                 All previous versions of ZDir sometimes would give incorrect
  109.                 listings or even lock up in directories with 254 or 255
  110.                 files.  *Fixed*
  111.  
  112.                 ZDir 1.3 and 1.4 did not display the top two lines on
  113.                 8088/8086 system.  *Fixed*
  114.  
  115.                 ZDir 1.4 would lock up on CGA systems--sorry about that!
  116.                 *Fixed*
  117.  
  118.                 When doing a Full path search, the final report would give
  119.                 an incorrect number of directories searched (in version 1.4
  120.                 only).  *Fixed*
  121.  
  122.                 The alternate output would not get the first line of the
  123.                 display (in version 1.4 only).  *Fixed*
  124.  
  125.                 Now, Ctrl-C and Ctrl-break will actually quit ZDir at almost
  126.                 any time.
  127. -------------------------------------------------------------------------------
  128.         1.4 Bug fixes:
  129.  
  130.                 A slight glitch in the attribute changing mechanism sometimes
  131.                 would cause a divide overflow.  *Fixed*
  132.  
  133.                 ZDir would sometimes not scroll up the screen at the end,
  134.                 and so the bottom line of information would be overwritten.
  135.                 *Fixed*
  136.  
  137.                 If a directory had the same extension (or lack thereof) as
  138.                 one of the 30 specified on the configuration screen, the
  139.                 directory name was shown in the extension color, not the
  140.                 directory color.  *Fixed*
  141.  
  142.                 If run in graphics mode ZDir did not switch into text mode
  143.                 and display a listing.  *Fixed*
  144.  
  145.                 File entries with a year or 2101 or larger would make the
  146.                 display be misaligned.  *Fixed*
  147.  
  148.         1.4 Enhancements:
  149.  
  150.                 The current time and date as reported by DOS are now printed
  151.                 on the top line of the display.  The second line has the path
  152.                 and volume label.
  153.  
  154.                 Certain long paths will not fit on the same line as the
  155.                 volume label.  If a path will not fit, the minimum number
  156.                 of directories needed to make the path fit are removed
  157.                 from the display, replaced by a \...\.  For example, running
  158.                 ZDir c:\dos\util\sharewar.e\dir\awesome\colorful\best\zdir.com
  159.                 ZDir may need to replace the path spec with
  160.                 c:\...\dir\awesome\colorful\best\zdir.com in order to fit it
  161.                 on the screen.
  162.  
  163.                 Commas are now printed in the numbers in the summaries for
  164.                 easier reading.  A new options in the Default Configuration
  165.                 Screen allows you to select whether file sizes have commas
  166.                 put in them as well (except for 6 digit file sizes in non-
  167.                 one column mode -- commas wouldn't fit!).  The new command
  168.                 line option , (e.g. ZDir /,) toggles the default.
  169.  
  170.                 In the Color Configuration Screen, page up and page down
  171.                 now change the foreground color, and ctrl-page up and
  172.                 ctrl-page down change the background color.
  173.  
  174.                 When string searching is enabled and you run
  175.                 ZDir d:\directory, ZDir will assume you meant
  176.                 ZDir d:\directory\*.*, saving you the typing of the \.
  177.  
  178.                 When doing file finds with the F option, directories are
  179.                 shown directly after their parent, instead of all directories
  180.                 one level deep, then all directories 2 levels deep, etc.
  181.  
  182.                 New choice in Default Configuration Screen:  All information
  183.                 about each file can be the same color as the file.
  184.  
  185.                 The Y command in conjunction with an attribute changing
  186.                 command will now change the attributes of all found
  187.                 directories as well as all found files.
  188.  
  189.                 Ctrl-Break will now abort ZDir most of the time.
  190.  
  191.                 During the "advertisement" in the unregistered version,
  192.                 the escape key now quits back to DOS.
  193.  
  194.                 ZDir now fully supports any number of rows on the screen
  195.                 (including 43 and 50 line modes).
  196. -------------------------------------------------------------------------------
  197.         1.3 Bug fixes:
  198.                 When the disk drive being listed was created with SUBST or
  199.                 ASSIGN ZDir incorrectly tried to list (drive):\\*.*.  *Fixed*
  200.  
  201.                 When Auto-detect columns was on and ZDir /1 (or 2, 3, 4, 6, or
  202.                 W) /q was then typed, auto-detection was not turned off.
  203.                 *Fixed*
  204.  
  205.                 Files with a year of 200x were displayed incorrectly.
  206.                 *Fixed*
  207.  
  208.                 When run directly from other programs, there was usually a
  209.                 divide overflow.  *Fixed*
  210.  
  211.                 String searches of over 8 characters were truncated to only
  212.                 8 characters.  *Fixed*
  213.  
  214.         1.3 Enhancements:
  215.  
  216.                 Secondary sort type can now be specified in the /Q Default
  217.                 Configuration Screen.  Any ties between files on the primary
  218.                 sort type will be broken by the secondary sort type.  Any ties
  219.                 on the secondary sort type are broken by filename.
  220.  
  221.                 In the Default Configuration Screen, two new choices have been
  222.                 added:  (1) Show the . and .. files, or totally ignore them,
  223.                 and (2) include directories in the file count, or do not count
  224.                 them.
  225.  
  226.                 The command L(filename) sends the output of ZDir to a file
  227.                 or device.  It writes graphic lines only if that option is on.
  228.                 It will not write over existing files.
  229.                 Example:  ZDir *.WK3 /LC:\spread.lst
  230.                 To send output to the modem, type ZDir /Laux
  231.                 The P command has been disabled, so to send output to the
  232.                 printer, type ZDir /Lprn
  233.  
  234.                 The M command turns on ANSI color control on the secondary
  235.                 output device specified with the L command, for this run only.
  236.                 NEVER turn this on when output is to the printer.
  237.  
  238.                 The Color configuration screen is now more user friendly,
  239.                 as you can hit page up and page down to change the color
  240.                 when the arrow points to the extension.
  241.  
  242.                 The Network attribute is now shown whenever the other
  243.                 attributes are shown, at the end (if all file attributes
  244.                 are on, it would show AHRSN).  With 2 column display, the
  245.                 N may touch the file date.
  246. -------------------------------------------------------------------------------
  247.         1.2 Bug fixes:
  248.                 File sizes over 1 meg were displayed 1 character to the left.
  249.                 *Fixed*
  250.  
  251.                 Directories with over 1000 files would make ZDir lock up.
  252.                 *Fixed*
  253.  
  254.                 Volume labels were sometimes displayed with a . (period) that
  255.                 was incorrect.  *Fixed*
  256.  
  257.         1.2 Enhancements:
  258.  
  259.                 String searching function--when a file name is given without
  260.                 wild cards, all files are searched for the string anywhere
  261.                 in the name (I option toggles on/off).
  262.  
  263.                 When outputting to the printer, display is shown on the
  264.                 screen as well, and the G option toggles printing graphic
  265.                 line characters or replacing them.
  266.  
  267.                 The Q command now invokes a full screen editor of default
  268.                 options.
  269.  
  270.                 K command toggles the wait for key at the end of every
  271.                 displayed screen, B command toggles BIOS screen writes,
  272.                 and E command toggles clearing the screen to start.
  273.  
  274.                 Full path search with the F command will locate all files
  275.                 in the specified directory and all of its subdirectories.
  276.  
  277.                 Auto-column detection (with the U command) will determine
  278.                 how many columns to use in the display depending on the
  279.                 number of files found.
  280.  
  281.                 One column mode now displays the space taken up be each
  282.                 individual file, in the 'totals information' color, as
  283.                 well as the network attribute with an N.
  284.  
  285.                 Attribute changing added with the [+|- A|H|R|S] commands.
  286. -------------------------------------------------------------------------------
  287.         1.1 Bug fixes:
  288.  
  289.                 File errors (when saving default colors and settings) were
  290.                 not reported.  *Fixed*
  291.  
  292.                 In certain cases file sizes with a 0 in the thousands' place
  293.                 would be printed incorrectly.  *Fixed*
  294.  
  295.                 Commands such as ZDir .com were not correctly expanded to
  296.                 ZDir *.com. *Fixed*
  297.  
  298.                 Incorrect drive specification was not reported. *Fixed*
  299.  
  300.                 If ZDir was run from a directory with an extension, then the
  301.                 directory contents were not shown. *Fixed*
  302.  
  303.                 Some large directories had a "using up" space that was
  304.                 incorrect. *Fixed*
  305.  
  306.         1.1 Enhancements:
  307.  
  308.                 Addition of 2, 3, 4, and 6 column modes added using the #
  309.                 as a command line parameter.
  310.  
  311.                 Printer support through the P parameter.
  312.  
  313.                 The cursor is now placed at the current row on the screen,
  314.                 so that on systems with only 1 drive emulating 2 the
  315.                 message "Place disk in B:" will be visible.
  316.  
  317.                 A - or a / may be used to specify command line arguments.
  318.                 Arguments may be specified by either /|-[args] (such as /z1)
  319.                 or /|-[arg1] /|-[arg2] /|-[arg3] (such as /z -1).
  320.  
  321.                 The configuration is now MUCH more user friendly.
  322.  
  323.                 Files with a volume label attribute are now also printed,
  324.                 so that there is no way to hide files from ZDir.
  325.  
  326.                 Up to 30 extensions and their colors may now be specified.
  327.  
  328.                 File sizes of 1 megabyte or larger are now displayed in terms
  329.                 of Megabytes, such as 1.0M, 14.4M, 52.8M.
  330.  
  331.                 The top of the display is now better, using up only one line,
  332.                 or two if the path specification is long ( >36 characters).
  333.  
  334.                 Secondary sorting by file name added.
  335.  
  336.                 And many other niceties, including a faster sorting algorithm.
  337. -------------------------------------------------------------------------------
  338.         1.0     First public release of ZDir.
  339.